[{"name":"oik bwtrace","slug":"oik-bwtrace","version":"3.4.7","author":"bobbingwide","author_profile":"https://profiles.wordpress.org/bobbingwide/","requires":"5.0","tested":"6.6.2","requires_php":"5.6","requires_plugins":[],"rating":100,"ratings":{"1":0,"2":0,"3":0,"4":0,"5":1},"num_ratings":1,"support_threads":1,"support_threads_resolved":0,"downloaded":4675,"last_updated":"2024-07-05 6:48am GMT","added":"2015-09-08","homepage":"https://www.oik-plugins.com/oik-plugins/oik-bwtrace","sections":{"description":"

Debug trace for WordPress, including ad hoc action hook and filter tracing.

The primary purpose of debug trace is to help in the development of PHP code: plugins or themes.
The primary purpose of action trace is to help you understand the sequence of events in the server.
The primary purpose of ad hoc tracing is to let you see what’s happening without changing any code.
The primary purpose of ‘string watch’ is to track the source of some output.
This plugin provides the admin interface to trace functions and methods and action and filter tracing.

oik bwtrace does not alter the output of your web pages though there are options
\nwhich cause some output to be written to the browser during ‘shutdown’ processing.

You can also use the oik trace facilities to assist in problem determination in a live site.
\nOutput is written to files on the server in a user defined trace files directory.
\nWhen tracing a live or staging site you should ensure that the trace files directory is not publicly accessible.

Features:

Traces to a defined Trace files directory
Traces ALL server functionality, including AJAX, REST and other background requests
Writes summary trace record for each transaction into Daily Trace summary files
Traces browser transactions separately, if required
Traces AJAX transactions separately, if required
Traces REST requests separately, if required
Traces CLI requests separately, if required
Ability to choose the IP address to trace, defaults to ALL requests
Supports ad hoc tracing of user defined hooks
Action trace counts help you understand the sequence of actions and filters
Provides contextual information
Minimum performance overhead when tracing is not enabled
Tracing can be enabled programmatically
Traces and backtraces PHP Error, Warning and Notice messages
Backtraces deprecated logic messages
Does not require WP_DEBUG to be defined
Does not require SAVEQUERIES to be defined
Dynamically activates trace functions
Implemented as lazy just-in-time code
Can be used during regression testing
Can be activated in wp-config.php and db.php to trace code before WordPress is fully loaded
Plugin does not need to be activated if started programmatically or from wp-config.php
Operates as a standalone plugin
Integrated with oik-lib shared library management
Easy to code APIs: bw_trace2(), bw_backtrace().
API supports multiple trace levels

Ad hoc tracing allows you to:

trace parameters
trace results
trace registered functions
trace the global post
set the priority for the trace hook
debug backtrace hook invocation
perform ‘string watch’ to watch for a particular string

The trace record output can include:

Fully qualified source file name
Trace record count and trace error count
Time stamp
Current filter information
Hook count
Number of database queries that have been performed.
Current post ID
Current and peak memory usage (in bytes)
Files loaded count
Contextual information

The output for action tracing can include trace records showing:

Count of action hooks and filters
Invocation of the ‘wp’ actions
Contents of the global wp_rewrite for the ‘wp’ action
Summary reports at ‘shutdown’
Information about deprecated logic
Information related to Errors, Warnings and Notices

New in v3.4.0

Experimental Performance trace option
Experimental front end links to trace file and daily trace summary

Is there a tutorial?

See this page and short video
\nIntroduction to oik-bwtrace

Can I get support?

Use the contact form on the oik-plugins website.

How can I contribute?

[github bobbingwide oik-bwtrace]

Upload the contents of the oik-bwtrace plugin to the `/wp-content/plugins/oik-bwtrace’ directory
Activate the oik-bwtrace plugin through the ‘Plugins’ menu in WordPress
Define your trace options using Settings > oik trace options
Define your action trace options using Settings > oik action options
Don’t forget to disable tracing when you no longer need it
Don’t forget to purge the trace output when you no longer need it

\n","faq":"\n

\nWhere is the FAQ?\n\n

oik-bwtrace FAQ

\nWhere is the documentation?\n\n

oik-bwtrace – debug trace for WordPress

\n\n","changelog":"

3.4.7

Changed: Reconcile bobbfunc shared library.
Tested: With WordPress 6.6-RC2 and WordPress Multisite
Tested: With PHPUnit 9.6
Tested: With PHP 8.3

\n","screenshots":"

$\"Trace$
Trace files directory box
$\"Trace$
Trace options - Requests sections
$\"Trace$
Trace options - Trace records
$\"Daily$
Daily Trace Summary box
$\"Action$
Action options - Options
$\"Action$
Action options - Ad hoc tracing
$\"Trace$
Trace information box
$\"Raw$
Raw trace output
$\"Daily$
Daily Trace Summary file

"},"short_description":"Debug trace for WordPress, including ad hoc action hook and filter tracing.","download_link":"https://downloads.wordpress.org/plugin/oik-bwtrace.3.4.7.zip","screenshots":{"1":{"src":"https://ps.w.org/oik-bwtrace/trunk/screenshot-1.jpg?rev=3112872","caption":"Trace files directory box"},"2":{"src":"https://ps.w.org/oik-bwtrace/trunk/screenshot-2.jpg?rev=3112872","caption":"Trace options - Requests sections"},"3":{"src":"https://ps.w.org/oik-bwtrace/trunk/screenshot-3.jpg?rev=3112872","caption":"Trace options - Trace records"},"4":{"src":"https://ps.w.org/oik-bwtrace/trunk/screenshot-4.jpg?rev=3112872","caption":"Daily Trace Summary box"},"5":{"src":"https://ps.w.org/oik-bwtrace/trunk/screenshot-5.jpg?rev=3112872","caption":"Action options - Options"},"6":{"src":"https://ps.w.org/oik-bwtrace/trunk/screenshot-6.jpg?rev=3112872","caption":"Action options - Ad hoc tracing"},"7":{"src":"https://ps.w.org/oik-bwtrace/trunk/screenshot-7.jpg?rev=3112872","caption":"Trace information box"},"8":{"src":"https://ps.w.org/oik-bwtrace/trunk/screenshot-8.jpg?rev=3112872","caption":"Raw trace output"},"9":{"src":"https://ps.w.org/oik-bwtrace/trunk/screenshot-9.jpg?rev=3112872","caption":"Daily Trace Summary file"}},"tags":{"ad-hoc-tracing":"ad hoc tracing","backtrace":"backtrace","debug":"debug","trace":"trace"},"versions":{"2.0.11":"https://downloads.wordpress.org/plugin/oik-bwtrace.2.0.11.zip","2.0.5":"https://downloads.wordpress.org/plugin/oik-bwtrace.2.0.5.zip","2.0.6":"https://downloads.wordpress.org/plugin/oik-bwtrace.2.0.6.zip","2.0.7":"https://downloads.wordpress.org/plugin/oik-bwtrace.2.0.7.zip","2.0.8":"https://downloads.wordpress.org/plugin/oik-bwtrace.2.0.8.zip","2.0.9":"https://downloads.wordpress.org/plugin/oik-bwtrace.2.0.9.zip","2.1.1":"https://downloads.wordpress.org/plugin/oik-bwtrace.2.1.1.zip","3.0.0":"https://downloads.wordpress.org/plugin/oik-bwtrace.3.0.0.zip","3.2.1":"https://downloads.wordpress.org/plugin/oik-bwtrace.3.2.1.zip","3.2.2":"https://downloads.wordpress.org/plugin/oik-bwtrace.3.2.2.zip","3.3.1":"https://downloads.wordpress.org/plugin/oik-bwtrace.3.3.1.zip","3.4.0":"https://downloads.wordpress.org/plugin/oik-bwtrace.3.4.0.zip","3.4.1":"https://downloads.wordpress.org/plugin/oik-bwtrace.3.4.1.zip","3.4.2":"https://downloads.wordpress.org/plugin/oik-bwtrace.3.4.2.zip","3.4.3":"https://downloads.wordpress.org/plugin/oik-bwtrace.3.4.3.zip","3.4.5":"https://downloads.wordpress.org/plugin/oik-bwtrace.3.4.5.zip","3.4.6":"https://downloads.wordpress.org/plugin/oik-bwtrace.3.4.6.zip","3.4.7":"https://downloads.wordpress.org/plugin/oik-bwtrace.3.4.7.zip","trunk":"https://downloads.wordpress.org/plugin/oik-bwtrace.zip"},"donate_link":"https://www.oik-plugins.com/oik/oik-donate/","icons":{"1x":"https://ps.w.org/oik-bwtrace/assets/icon-128x128.jpg?rev=1252919","2x":"https://ps.w.org/oik-bwtrace/assets/icon-256x256.jpg?rev=1240792"}}]

Is there a tutorial?

Can I get support?

How can I contribute?

Further reading

3.4.7

ad hoc tracing

oik bwtrace

Get New Themes & Resources